Ozon Seller API — программный интерфейс для работы с маркетплейсом Ozon. Он даёт возможность обмениваться информацией между системой продавца и Ozon.

Методы Seller API позволяют изменять данные магазина, например, остатки товаров или их стоимость, и получать данные, такие как информация о возвратах или список складов.

Работа с API состоит из отправки запроса и получения ответа. Для этого можно использовать вкладку Консоль, которая находится сверху описания методов, Postman или настроить интеграцию с системами учёта, например, 1С, ERP или МойСклад.

При интеграции системы учёта продавца с Seller API обновлять и получать данные можно в автоматическом режиме. Это поможет поддерживать актуальной информацию о ценах и остатках товаров, обрабатывать больше заказов за меньшее время и исключить ошибки из-за обновления данных вручную.

Например, вам нужно обновить информацию об остатках или ценах 100 товаров. Чтобы сделать это через личный кабинет, необходимо вручную изменить данные на карточке каждого товара.

Метод /v2/products/stocks позволяет одним запросом обновить информацию об остатках сразу 100 товаров, а метод /v1/product/import/prices — их стоимость.

• Загружать и обновлять товары.
• Управлять ценами и остатками по товарам.
• Получать информацию о возвратах товаров.
• Управлять заказами FBO, FBS и rFBS.
• Управлять чатами.
• Работать с накладными.
• Получать финансовую и аналитическую информацию.
• Получать выгрузку атрибутов и характеристик Ozon.

Перед началом работы с Ozon Seller API:

1. Изучите процессы работы с Ozon в Базе знаний продавца и личном кабинете продавца.
2. Определите процессы, которые планируете автоматизировать, и сравните их с процессами вашей компании.
3. Изучите документацию Seller API и разработайте схему интеграции.

Для работы с Seller API необходим API-ключ. Подробнее в разделе Авторизация.

Seller API работает по UTC. Учитывайте это, когда отправляете запросы и получаете ответы с датами и временем.

Процесс работы с Seller API можно разделить на блоки:

• работа с атрибутным деревом,
• загрузка и обновление товаров,
• управление ценами,
• управление остатками товара,
• управление заказами FBO,
• управление заказами FBS и rFBS,
• работа с накладными,
• получение финансовой информации,
• получение аналитической информации,
• управление возвратами,
• управление чатами.

1. Зарегистрируйтесь в Ozon Seller. Подробнее о регистрации в Базе знаний продавца.
2. Получите API-ключ.

Чтобы получить API-ключ:

1. В личном кабинете перейдите в Настройки → Seller API.
2. Нажмите Сгенерировать ключ.
3. Придумайте название для ключа и выберите его уровень доступа.
4. Нажмите Сгенерировать.

Вы можете создать несколько API-ключей. Например, если у вас несколько пользователей с разными уровнями доступа.

Отредактировать ключ

Если вы хотите изменить разрешённые сети для ключа, в списке API-ключей выберите нужный и нажмите . Внесите изменения и нажмите Обновить.

1. В личном кабинете перейдите в Настройки → Seller API.
2. Удалите текущий API-ключ и создайте новый.

Чтобы получить OAuth-токен для доступа к Seller API, создайте частное или публичное приложение и выдайте ему доступ к вашему личному кабинету. После этого вы получите OAuth-токен, который позволит работать с методами Seller API.

Используйте OAuth-токен с методами Seller API согласно уровням доступа, которые вы назначили приложению.

Пример запроса:

POST https://api-seller.ozon.ru/{эндпоинт метода Seller API}
Authorization: Bearer ACCESS_TOKEN

Рабочая среда — это ваш магазин. Все отправленные запросы, кроме информационных, могут изменять данные в личном кабинете и на сайте Ozon.

Рабочая среда: api-seller.ozon.ru

Созданные товары можно посмотреть по ссылке вида: https://www.ozon.ru/context/detail/id/SKU, где вместо «SKU» нужно указать значение для созданного товара.

GET / HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: <Client-Id>
Api-Key: <Api-Key>
Content-Type: application/json

Для проверки корректности формата запроса используйте вкладку Консоль над описанием метода или Postman.

1. /v1/description-category/tree — получите список категорий и типов в виде дерева и используйте значение последнего уровня выбранной категории.

2. /v1/description-category/attribute — получите характеристики для выбранных категории и типа.

3. /v1/description-category/attribute/values — получите список значений для выбранной характеристики.

После сравнения своих атрибутов и характеристик с атрибутной моделью Ozon можете приступить к загрузке товаров:

1. /v3/product/import — загрузите товары и услуги. Этот метод также позволяет обновить уже загруженные товары. В запросе устанавливается первичная цена и загружаются изображения товара.

   В одном запросе можно передать до 100 товаров. Изображения загружаются прямой ссылкой на облачное хранилище, где они хранятся.

   В результате работы метода вы получите task_id — номер задания на загрузку товаров.

2. /v1/product/import/info — проверьте task_id, который вы получили при загрузке товаров. Метод вернёт информацию, успешно ли загрузились товары или при импорте была ошибка.

   Если ответ содержит статус, что товар на модерации, подождите её результатов и проверьте статус товара повторно. Обычно модерация занимает меньше одного дня.

3. /v3/product/list — получите список созданных товаров после загрузки товаров.

   Метод позволяет использовать фильтры, чтобы разбить товары на группы по статусу видимости или отслеживать изменение их статуса с помощью идентификатора товара.

   Метод возвращает пару значений offer_id и product_id — они нужны практически во всех запросах для идентификации товара, с которым будет производиться действие. Если вы загружали товары через шаблон, используйте этот метод для получения offer_id и product_id, чтобы в дальнейшем работать по API с товарами.

Чтобы добавить изображения товара или заменить существующие, используйте:

1. /v1/product/pictures/import — загрузите или обновите изображения товара. Передайте прямые ссылки на изображения, загруженные в облачное хранилище.
2. /v2/product/pictures/info — проверьте статус загрузки.

Чтобы обновить информацию о товаре и его характеристики, используйте /v3/product/import.

Если нужно обновить только характеристики товара, используйте /v1/product/attributes/update.

• /v3/product/info/list — получите информацию о товаре, например штрихкод, цену главного предложения, идентификатор категории, комиссию или ошибки модерации. С помощью фильтров /v3/product/list получите список пакетно по всем товарам сразу или по категориям.

• /v4/product/info/attributes — получите описание характеристик товара. Метод позволяет добавить дополнительную информацию к товару, чтобы карточка товара была более полной.

• /v1/product/info/description — получите описание товара, чтобы использовать его для создания схожего товара.

• /v1/product/info/discounted — получите информацию об уценке и основном товаре по SKU уценённого товара.

1. /v2/products/delete — удалите товар, если он загрузился с ошибкой и попал в архив без SKU. Товары, которые успешно прошли модерацию и получили SKU, удалить из архива нельзя.

2. /v1/product/archive — перенесите товар в архив. Перед архивированием товара обнулите его остатки.

3. /v1/product/unarchive — верните товар из архива.

Товар попадёт в продажу, только когда вы установите его остаток.

• Получите список типов сертификатов: /v1/product/certificate/types.
• Получите список сертифицируемых категорий: /v2/product/certification/list.
• Получите список статусов сертификата: /v1/product/certificate/status/list.
• Получите список типов соответствия требованиям: /v2/product/certificate/accordance-types/list.
• Получите список причин отклонения сертификата: v1/product/certificate/rejection_reasons/list.
• Получите список сертификатов: v1/product/certificate/list, используя фильтры:
  • тип сертификата type — значение value из ответа /v1/product/certificate/types;
  • статус сертификата status — значение code из ответа v1/product/certificate/status/list.

Чтобы привязать сертификат к товару:

1. Получите список брендов, для которых требуется предоставить сертификат: /v1/brand/company-certification/list. В ответе вернутся бренды, товары которых есть в вашем личном кабинете. Список брендов может изменяться, если Ozon получит требование от бренда предоставлять сертификат.
2. Добавьте сертификаты для товаров: /v1/product/certificate/create.
3. Привяжите сертификат к товару: /v1/product/certificate/bind.

Чтобы посмотреть список товаров, привязанных к сертификату, воспользуйтесь методом v1/product/certificate/products/list. Если нужно получить список товаров с определённым статусом, в параметре status передайте значение code из ответа v1/product/certificate/product_status/list.

Чтобы отвязать товар от сертификата, используйте /v1/product/certificate/products/unbind.

Чтобы получить атрибуты для управления сертификатом:

1. Получите список типов сертификатов: /v1/product/certificate/types.
2. Получите список типов соответствия требованиям: /v2/product/certificate/accordance-types/list.

Для создания сертификата используйте /v1/product/certificate/create, передав в запросе:

• тип сертификата type_code — значение value из ответа /v1/product/certificate/types;
• тип соответствия требованиям accordance_type_code — значение code из ответа /v2/product/certificate/accordance-types/list.

Чтобы удалить сертификат, используйте /v1/product/certificate/delete.

После загрузки товаров для схем FBS и rFBS можно перейти к обновлению остатков. Для схемы FBO остатки обновляются автоматически по факту продажи.

Для обновления остатков используйте метод /v2/products/stocks. В этом методе дополнительно указывается идентификатор склада, на котором необходимо изменить остатки.

Для получения информации о количестве остатков для FBO используйте /v4/product/info/stocks.

Для получения информации о количестве остатков для FBS и rFBS используйте v1/product/info/stocks-by-warehouse/fbs.

Чтобы обновить цены по товарам и не менять карточку товара, используйте /v1/product/import/prices.

Метод позволяет обновить цену:

• до скидок,
• для клиентов с подпиской Ozon Premium,
• на карточке товара с учётом скидок,
• минимальную цену товара после применения акций.

Для получения информации о ценах, комиссиях и скидках на товары используйте /v5/product/info/prices.

Если товары заказывают юридические лица, оплата может поступать не сразу — система зарезервирует товары. Чтобы проверить остатки, используйте методы /v3/posting/fbs/get, /v3/posting/fbs/list или /v3/posting/fbs/unfulfilled/list. Если в ответе is_legal = true, значит среди остатков есть зарезервированные товары. Вы можете обновить остатки так, чтобы новое количество товаров было больше свободного остатка и зарезервированного товара в сумме. Система спишет старый остаток и рассчитает новый.

Чтобы проверить резервирование товара, используйте методы /v1/product/info/stocks-by-warehouse/fbs или /v4/product/info/stocks.

Подробнее об изменении остатков

Для продвижения товаров участвуйте в акциях, которые Ozon проводит для покупателей.

• Получите список доступных акций: /v1/actions.

• Получите список товаров, которые могут участвовать в акции: /v1/actions/candidates.

• Добавьте товары в акцию: /v1/actions/products/activate.

• Получите список товаров, которые участвуют в акции: /v1/actions/products.

• Удалите товары из акции: /v1/actions/products/deactivate.

Покупатели могут попросить у вас скидку на товар. Чтобы получить список товаров, которые покупатели хотят купить со скидкой, воспользуйтесь методом /v1/actions/discounts-task/list. Заявки в статусах NEW (новые) или SEEN (просмотренные) вы можете:

• одобрить — используйте метод /v1/actions/discounts-task/approve,
• отклонить — используйте метод /v1/actions/discounts-task/decline.

Подробнее об акциях в Базе знаний продавца

Стратегии ценообразования — инструмент для автоматического изменения стоимости товаров в соответствии с ценами на аналогичные товары в других интернет-магазинах и маркетплейсах.

Подробнее о стратегиях в Базе знаний для продавцов из России

Подробнее о стратегиях в Справке для продавцов Ozon Global

Чтобы настроить стратегии ценообразования:

1. Получите список конкурентов: /v1/pricing-strategy/competitors/list.

2. Получите список стратегий ценообразования: /v1/pricing-strategy/list.

3. Создайте свою стратегию: /v1/pricing-strategy/create и установите коэффициенты, чтобы изменять стоимость товара по сравнению с другими площадками в большую и меньшую сторону. Чтобы получить информацию о стратегии, используйте метод /v1/pricing-strategy/info.

4. Добавьте товары в стратегию: /v1/pricing-strategy/products/add.

   Вы можете добавить товары:

   • На которые установлена минимальная цена с помощью метода /v1/product/import/prices. Чтобы проверить цену, используйте метод /v5/product/info/prices.
   • Которые не привязаны к другой стратегии. Чтобы проверить привязку товара к стратегии, используйте метод /v1/pricing-strategy/strategy-ids-by-product-ids.

   Чтобы получить список товаров, которые привязаны к стратегии, используйте метод /v1/pricing-strategy/products/list, а для удаления товаров из стратегии — /v1/pricing-strategy/products/delete.

5. Включите или отключите стратегию: /v1/pricing-strategy/status.

Чтобы изменить список выбранных конкурентов и название стратегии, используйте метод /v1/pricing-strategy/update.

Для удаления стратегии используйте метод /v1/pricing-strategy/delete.

• /v1/delivery-method/list — получите список методов склада.

• /v1/warehouse/list — получите список складов.

1. /v1/warehouse/fbs/create/drop-off/list — получите список drop-off точек и выберите одну, чтобы создать склад.
2. /v1/warehouse/fbs/return-mile/check — проверьте необходимость установки возвратной мили.
3. /v1/warehouse/fbs/create/return-point/list — получите список возвратных пунктов для создания склада.
4. /v1/warehouse/fbs/create — отправьте запрос на создание нового склада.
5. /v1/warehouse/operation/status — получите статус операции на создание нового склада.
6. /v2/warehouse/list — получите подробную информацию о складе по warehouse_id.

1. /v1/warehouse/fbs/update — отправьте запрос на обновление настроек склада.
2. /v1/warehouse/operation/status — получите статус обновления информации о складе.

1. /v1/warehouse/fbs/return-mile/info — проверьте необходимость передачи возвратной мили.
2. /v1/warehouse/fbs/update/return-point/list — получите список пунктов возвратов для обновления склада.
3. /v1/warehouse/fbs/update/drop-off/list — получите список drop-off точек и выберите одну, чтобы обновить информацию о складе.
4. /v1/warehouse/fbs/first-mile/update — отправьте запрос на обновление первой мили.
5. /v1/warehouse/operation/status — получите статус обновления первой мили.

1. /v1/warehouse/fbs/return-mile/info или /v1/warehouse/fbs/return-mile/check — проверьте необходимость установки возвратной мили.
2. /v1/warehouse/fbs/update/return-point/list — получите список пунктов возвратов для обновления склада.
3. /v1/warehouse/archive — перенесите склад в архив.
4. /v1/warehouse/operation/status — получите статус архивации склада.

1. /v1/warehouse/fbs/return-mile/info или /v1/warehouse/fbs/return-mile/check — проверьте необходимость установки возвратной мили.
2. /v1/warehouse/fbs/update/return-point/list — получите список пунктов возвратов для обновления склада.
3. /v1/warehouse/unarchive — уберите склад из архива.
4. /v1/warehouse/operation/status — получите статус разархивации склада.

Создайте новый склад

1. /v1/warehouse/erfbs/aggregator/create — создайте новый склад.
2. /v1/warehouse/operation/status — получите статус создания склада по идентификатору операции operation_id.
3. /v1/delivery-method/return/settings/get — получите информацию по возвратным настройкам.

Обновите информацию о складе

• /v1/warehouse/erfbs/update — обновите информацию о складе.
• /v1/warehouse/erfbs/aggregator/delivery-method/update — обновите информацию о методе доставки.
• /v1/warehouse/operation/status — получите статус изменения информации по идентификатору операции operation_id.

Создайте новый склад

1. /v1/warehouse/erfbs/non-integrated/create — создайте новый склад.
2. /v1/warehouse/operation/status — получите статус создания склада по идентификатору операции operation_id.
3. /v1/delivery-method/return/settings/get — получите информацию по возвратным настройкам.

Привяжите полигоны доставки к складу

1. /v1/polygon/create — создайте полигон доставки.
2. /v2/polygon/bind — привяжите полигон к методу доставки на складе.

Обновите информацию о складе

• /v1/warehouse/erfbs/update — обновите информацию о складе.
• /v1/warehouse/erfbs/non-integrated/delivery-method/update — обновите информацию о методе доставки.
• /v1/warehouse/operation/status — получите статус изменения информации по идентификатору операции operation_id.

Обновите информацию о полигонах доставки

• /v1/polygon/list — получите список полигонов доставки, которые привязаны к складу.
• /v1/polygon/delete — удалите полигон из области доставки.
• /v1/polygon/time/coordinates/update — обновите координаты полигона доставки.
• /v1/polygon/time/set — обновите время доставки в полигоне.

Обработайте заказы в зависимости от схемы работы:

• cхема FBO;
• стандартная схема FBS;
• схема FBS PickUp с подключённой доверительной приёмкой;
• Ozon Логистика;
• стандартная схема rFBS;
• схема rFBS Express с доставкой в пункт выдачи;
• схема rFBS с доставкой через интегрированную службу;
• схема rFBS Агрегатор.

Если вы продаёте товары из-за рубежа, обрабатывайте заказы по одной из схем:

• rFBS Crossborder;
• rFBS Crossborder с интегрированной службой доставки;
• rFBS Агрегатор;
• схема FBP.

Подробнее о заказах с весовыми товарами при работе по схеме rFBS

Перед созданием заявки на поставку проверьте загруженность складов Ozon: /v1/supplier/available_warehouses.

Для получения списка отправлений, финансовой и аналитической информации используйте /v2/posting/fbo/list. Также метод возвращает информацию о проданных кодах активации с привязкой к номеру отправления.

Чтобы получить информацию по отправлению, используйте /v2/posting/fbo/get.

Создать заявку на поставку

1. /v1/cluster/list — получите информацию по кластерам и их складам.
2. /v1/warehouse/fbo/list — получите идентификаторы складов, пунктов выдачи заказов и сортировочных центров для отгрузки кросс-докингом.
3. /v1/draft/create — создайте черновик заявки на поставку. Для этого передайте список поставляемых товаров, тип поставки и, при доставке кросс-докингом, точку отгрузки.
4. /v1/draft/create/info — получите статус создания черновика и информацию по нему.
5. /v1/draft/timeslot/info — получите доступные таймслоты для конечных складов отгрузки. Максимальный период — 28 дней, начиная с текущей даты.
6. /v1/draft/supply/create — создайте заявку на поставку по черновику.
7. /v1/supply/create/status — получите статус создания заявки на поставку. Когда заявка будет создана, метод вернёт идентификаторы заявок на поставку.

Получите информацию о заявках на поставку

Для поставки на фулфилмент Ozon нужна заявка. В ней указано, какие товары и в каком количестве вы привезёте.

1. /v2/supply-order/list — получите список заявок на поставку.
2. /v1/supply-order/status/counter — получите статус заявки и количество поставок в этом статусе.
3. /v2/supply-order/get — получите информацию по заявке.
4. v1/supply-order/bundle — получите состав поставки или заявки на поставку.

Для проезда на фулфилмент выберите интервал поставки и оформите пропуск для водителя и автомобиля. Для этого:

1. /v1/supply-order/timeslot/get — получите список доступных интервалов.
2. /v1/supply-order/timeslot/update — измените выбранный интервал.
3. /v1/supply-order/timeslot/status — получите статус закрепления интервала.
4. /v1/supply-order/pass/create — добавьте данные водителя и автомобиля.
5. /v1/supply-order/pass/status — получите статус ввода данных о водителе и автомобиле.

Управляйте грузоместами в заявке на поставку

1. /v1/cargoes/create — передайте количество грузомест и установите в каждое грузоместо товарный состав.
2. /v2/cargoes/create/info — получите информацию по установке грузомест и товарного состава.
3. /v1/cargoes-label/create — создайте задание на формирование этикеток грузомест.
4. /v1/cargoes-label/get — получите статус создания этикеток и идентификатор файла с ними.
5. /v1/cargoes-label/file/{file_guid} — получите PDF с этикетками грузовых мест.

1. Перед началом работы с отправлениями получите список необработанных отправлений: /v3/posting/fbs/unfulfilled/list.

   Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать страну-производителя для всех товаров в заказе, у которых она не указана. Получите список доступных для выбора стран: /v2/posting/fbs/product/country/list. Затем передайте информацию о стране-производителе: /v2/posting/fbs/product/country/set.

   Также можно получать список заказов (отправлений): /v3/posting/fbs/list. Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики, если поле with отправить со значением analytics_data.

   Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.

2. Получите дополнительную информацию о заказах: /v3/posting/fbs/get.

   В блоке requirements указывается:

   • какие товары подлежат обязательной маркировке;
   • нужно ли передать номер грузовой таможенной декларации и регистрационный номер партии товара — эту информацию также можно получить с помощью методов /v3/posting/fbs/list и /v3/posting/fbs/unfulfilled/list.

   Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.

3. Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.

   Получите идентификаторы экземпляров exemplar_id методом /v5/fbs/posting/product/exemplar/create-or-get.

   С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.

   Подробнее о маркировке «Честный ЗНАК» в Базе знаний

   Получите статусы передачи маркировок:

• /v4/fbs/posting/product/exemplar/status — получить статус добавления экземпляров.
• /v5/fbs/posting/product/exemplar/create-or-get — получить данные созданных экземпляров.

4. Перед сборкой убедитесь, что отправление соответствует установленным в пункте приёма ограничениям. Получите ограничения пункта приёма по номеру отправления: /v1/posting/fbs/restrictions.

5. До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:

   • заказ не в статусе awaiting_packaging;
   • вы не указали коды маркировки для товаров, подлежащих обязательной маркировке.

   При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.

   После использования метода статус отправления изменится на awaiting_deliver.

   Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.

6. Для каждого отправления распечатайте наклейку для идентификации в системе Ozon: /v2/posting/fbs/package-label.

7. Подтвердите отгрузку и запустите формирование транспортной накладной методом /v2/posting/fbs/act/create или создайте отгрузку с помощью метода /v1/carriage/create и подтвердите её методом /v1/carriage/approve. В ответе методов /v2/posting/fbs/act/create и /v1/carriage/create вы получите идентификатор созданной перевозки.

8. Запросите информацию о созданной поставке с помощью метода /v1/carriage/get. Массив available_actions содержит информацию о доступных действиях с поставкой и необходимости создать пропуск для проезда на склад Ozon.

   Чтобы создать пропуск, используйте метод /v1/carriage/pass/create. Чтобы после поставки товаров вы могли забрать возвраты на этой же машине, передайте значение with_returns = true. Для каждой поставки нужен новый пропуск.

   Для редактирования или удаления пропуска используйте методы /v1/carriage/pass/update и /v1/carriage/pass/delete.

   Список всех пропусков можно получить с помощью метода /v1/pass/list.

   Подробнее об оформлении пропусков

9. Получите список перевозок, по которым нужно распечатать штрихкод для отгрузки и транспортную накладную: /v1/posting/carriage-available/list или /v1/carriage/delivery/list.

10. Проверьте, что отгрузка создана: /v2/posting/fbs/act/check-status.

11. Получите штрихкод для отгрузки: /v2/posting/fbs/act/get-barcode.

12. Проверьте статус формирования накладной: /v2/posting/fbs/digital/act/check-status. Когда статус документа перейдёт в FORMED, получите файлы:

    • Транспортная накладная: /v2/posting/fbs/act/get-pdf.
    • Лист отгрузки: /v2/posting/fbs/digital/act/get-pdf.

После этого можете отвезти отправления и документы в пункт приёма.

Если отправление передано в доставку, но не просканировано в сортировочном центре, вы можете открыть спор: /v2/posting/fbs/arbitration. Открытый спор переведёт отправление в статус arbitration.

Если спор по отправлению откроет покупатель, статус отправления изменится на client_arbitration.

Чтобы отследить изменение статуса, когда отправление найдено, используйте /v3/posting/fbs/list с нужными фильтрами.

Для передачи спорных заказов к отгрузке используйте /v2/posting/fbs/awaiting-delivery. Статус отправления изменится на awaiting_deliver.

Отменить доставку отправления

1. Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.

2. Передайте этот список и номер отправления: /v2/posting/fbs/cancel.

Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.

Если отправление отменит покупатель, статус изменится на cancelled.

Работа с эконом-товарами

1. Создайте эконом-товары в личном кабинете.
2. Получите идентификаторы квантов с созданными товарами: /v1/product/quant/list.

Подробнее об эконом-товарах в Справке

Работа с отправлениями

1. Получите список необработанных отправлений: /v3/posting/fbs/list или /v3/posting/fbs/unfulfilled/list. В ответе проверьте:

   • is_blr_traceable — признак прослеживаемости товара;
   • require_blr_traceable_attrs = true — если нужно заполнить атрибуты прослеживаемости;
   • split_before_ship = true — если нужно разделить заказ.

2. Отфильтруйте прослеживаемые отправления, используя фильтр is_blr_traceable = true: /v3/posting/fbs/list.

3. Если заказ с прослеживаемостью, разделите его: /v1/posting/fbs/traceable/split.

4. Проверьте, нужно ли заполнять атрибуты прослеживаемости: /v1/posting/fbs/product/traceable/attribute.

5. Если атрибуты нужны, укажите их для карточки товара в личном кабинете или через API:

   • количество товара в УЕИ;
   • штрихкод GTIN.

6. Передайте экземпляры товара и соберите отправление: /v4/posting/fbs/ship.

Работа с перевозками

1. Получите список нулевых отгрузок: /v1/carriage/delivery/list. Прослеживаемые отгрузки будут иметь признак all_blr_traceable.

2. Создайте перевозку с прослеживаемыми товарами: /v1/carriage/create. В запросе укажите is_blr_traceable = true.

   Если точка отгрузки не поддерживает электронную ТТН, вернётся ошибка BLR_TRACEABLE_PICKUP_NOT_ALLOWED.

3. Получите информацию о созданной перевозке: /v1/carriage/get. В ответе получите признак all_blr_traceable.

4. Создайте и загрузите на проверку электронную ТТН через систему электронного документооборота — ЭДО.

5. Получите статус электронной ТТН: /v1/carriage/ettn/status.

6. Подтвердите перевозку: /v1/carriage/approve. Если электронная ТТН не прошла проверку, вернётся ошибка INCORRECT_E_WAYBILL_STATUS.

7. Обновите товарный состав перевозки, если нужно: /v1/carriage/set-postings. Если электронная ТТН не прошла проверку, вернётся ошибка INCORRECT_E_WAYBILL_STATUS.

1. Перед началом работы с отправлениями получите список необработанных отправлений: /v3/posting/fbs/unfulfilled/list.

   Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать страну-производителя для всех товаров в заказе, у которых она не указана. Получите список доступных для выбора стран: /v2/posting/fbs/product/country/list. Затем передайте информацию о стране-производителе: /v2/posting/fbs/product/country/set.

   Также можно получать список заказов (отправлений): /v3/posting/fbs/list. Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики, если поле with отправить со значением analytics_data.

   Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.

2. Получите дополнительную информацию о заказах: /v3/posting/fbs/get.

   В блоке requirements указывается:

   • какие товары подлежат обязательной маркировке;
   • нужно ли передать номер грузовой таможенной декларации и регистрационный номер партии товара — эту информацию также можно получить с помощью методов /v3/posting/fbs/list и /v3/posting/fbs/unfulfilled/list.

   Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.

3. Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.

   С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.

   Подробнее о маркировке «Честный ЗНАК» в Базе знаний

   Получите статусы передачи маркировок:

• /v4/fbs/posting/product/exemplar/status — получить статус добавления экземпляров.
• /v5/fbs/posting/product/exemplar/create-or-get — получить данные созданных экземпляров.

4. Перед сборкой убедитесь, что отправление соответствует установленным в пункте приёма ограничениям. Получите ограничения пункта приёма по номеру отправления: /v1/posting/fbs/restrictions.

5. До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:

   • заказ не в статусе awaiting_packaging;
   • вы не указали коды маркировки для товаров, подлежащих обязательной маркировке.

   При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.

   После использования метода статус отправления изменится на awaiting_deliver.

   Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.

6. Подтвердите отгрузку и запустите формирование транспортной накладной методом /v2/posting/fbs/act/create или создайте перевозку с помощью метода /v1/carriage/create и подтвердите её методом /v1/carriage/approve. В ответе методов /v2/posting/fbs/act/create и /v1/carriage/create вы получите идентификатор созданной перевозки.

7. Получите список перевозок, по которым нужно распечатать штрихкод для отгрузки и транспортную накладную: /v1/posting/carriage-available/list или /v1/carriage/delivery/list.

8. Проверьте статус формирования накладной: /v2/posting/fbs/digital/act/check-status. Когда статус документа перейдёт в FORMED, получите файлы:

   • Транспортная накладная: /v2/posting/fbs/act/get-pdf.
   • Лист отгрузки: /v2/posting/fbs/digital/act/get-pdf.

9. Для каждого отправления распечатайте наклейку для идентификации в системе Ozon: /v2/posting/fbs/package-label.

10. После того как вы упаковали все отправления по требованиям из раздела Доверительная приёмка грузового места в Базе знаний продавца, получите этикетки на каждое грузовое место: /v2/posting/fbs/act/get-container-labels.

После этого можете передать грузовое место в пункт приёма или курьеру Ozon.

Если отправление передано в доставку, но не просканировано в сортировочном центре, вы можете открыть спор: /v2/posting/fbs/arbitration. Открытый спор переведёт отправление в статус arbitration.

Если спор по отправлению откроет покупатель, статус отправления изменится на client_arbitration.

Чтобы отследить изменение статуса, когда отправление найдено, используйте /v3/posting/fbs/list с нужными фильтрами.

Для передачи спорных заказов к отгрузке используйте /v2/posting/fbs/awaiting-delivery. Статус отправления изменится на awaiting_deliver.

Доставка

1. v1/delivery/check — проверьте, может ли покупатель получить заказ через Ozon. Способы доставки для Ozon Логистики:

   • Самовывоз или pickup — покупатель сам забирает товар из точки выдачи заказов.
   • Курьерская или courier — курьер Ozon доставляет товар по выбранному адресу.

   Если способ доставки — самовывоз, передайте идентификатор точки самовывоза в параметр pickup. При курьерской доставке передайте адрес получения и координаты в параметр courier.

2. v1/delivery/map — укажите точки на карте, из которых покупатель может забрать заказ.

3. v1/delivery/point/list — получите список точек самовывоза.

4. /v1/delivery/point/info — получите информацию о точке самовывоза.

5. /v2/delivery/checkout — проверьте доступность товара и сроки доставки.

Предоставьте выбор способа доставки и точки доставки на этапе оформления заказа или в корзине. Если это невозможно, кешируйте данные на своей стороне, чтобы снизить нагрузку и оптимизировать количество запросов к API.

Обработка заказа

Создавайте заказ в системе Ozon только после того, как покупатель оплатил его.

1. v2/order/create — создайте заказ и начните сборку. После вызова метода изменить заказ не получится.
2. v2/posting/fbo/list и v3/posting/fbs/list — отследите все отправления или конкретное.
3. v1/posting/marks — получите маркировки экземпляров из отправления. Передавайте в этот метод только отправления, которые вы создали через методы Ozon Логистики.

Отслеживание отправлений

Для схемы FBO:

• v2/posting/fbo/list — получите список всех отправлений.
• v2/posting/fbo/get — получите информацию о конкретном отправлении.

Для схемы FBS:

• v3/posting/fbs/unfulfilled/list — получите список необработанных отправлений.
• v3/posting/fbs/list — получите список отправлений.
• v3/posting/fbs/get — получите информацию об отправлении.

Если покупатель при получении отправления отказался от одного из товаров, отправление останется в статусе «Доставлено». Используйте v1/returns/list, чтобы получить информацию по возврату с невыкупленным товаром. Тип такого возврата — type: PartialReturn.

Отмена заказа или отправления

Можно отменить заказы, которые создали с помощью методов Ozon Логистики, если:

• Ozon отменил заказ до поступления в пункт выдачи или перед доставкой покупателю.
• Покупатель не забрал заказ при получении — полностью или частично.
• Покупатель запросил отмену заказа через сайт или приложение продавца. Покупатель не может отменить заказ через личный кабинет Ozon.

Для отмены заказа или его части:

• /v1/cancel-reason/list-by-order — получите возможные причины отмены заказа.
• /v1/cancel-reason/list-by-posting — получите список доступных причин отмены отправления. Используйте метод, только если покупатель запросил отмену заказа.
• v1/order/cancel/check — проверьте, можно ли отменить заказ.
• v1/order/cancel — отмените заказ.
• v1/posting/cancel — отмените отправление из заказа.
• v1/order/cancel/status — проверьте статус отмены заказа.
• v1/posting/cancel/status — проверьте статус отмены отправления.

Для отмены FBS-отправлений:

• v2/posting/fbs/product/cancel — отмените отправку некоторых товаров в отправлении.
• v2/posting/fbs/cancel — отмените отправление.

Возврат товара

v1/returns/list — отследите статус возврата товара. Используйте, если покупатель отменил заказ во время перевозки или не забрал его при получении. Возвраты от покупателей продавец забирает своими силами. Если покупатель забрал товар и после этого решил его вернуть, он должен связаться с продавцом.

Если покупатель отказался от одного из товаров при получении отправления, оно останется в статусе «Доставлено». Система создаст новое отправление в статусе «Отменено» с типом отмены PartialRefund. Получите информацию о нём методом v1/returns/list.

Остатки

• v1/analytics/stocks — получите отчёт по остаткам на складах Ozon, чтобы планировать поставки товаров.
• v4/product/info/stocks — покажите покупателю количество товаров на складах Ozon.

Если на складах Ozon недостаточно товаров, создать заказ через методы Ozon Логистики не получится.

1. Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.

   Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать страну-производителя для всех товаров в заказе, у которых она не указана.
   Получите список доступных для выбора стран: /v2/posting/fbs/product/country/list. Затем передайте информацию о стране-производителе: /v2/posting/fbs/product/country/set.

   Также можно получать список заказов (отправлений): /v3/posting/fbs/list. Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики, если поле with отправить со значением analytics_data.

   Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.

   Если в параметре available_actions указано set_cutoff, уточните дату отгрузки отправления с помощью метода /v1/posting/cutoff/set. Сделайте это не позднее даты, которая указана в параметре shipment_date в методах: /v3/posting/fbs/unfulfilled/list, /v3/posting/fbs/list или /v3/posting/fbs/get. После даты shipment_date уточнить дату отгрузки и собрать отправление не получится.

2. Получите дополнительную информацию о заказах: /v3/posting/fbs/get.

   В блоке requirements указывается:

   • какие товары подлежат обязательной маркировке;
   • нужно ли передать номер грузовой таможенной декларации и регистрационный номер партии товара — эту информацию также можно получить с помощью методов /v3/posting/fbs/list и /v3/posting/fbs/unfulfilled/list.

   Если вы продаёте весовые товары, и в параметре result.products.is_weight_needed для товара указано true, передайте информацию о весе товара методом /v6/fbs/posting/product/exemplar/set.

   Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.

3. Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.

   С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.

   Подробнее о маркировке «Честный ЗНАК» в Базе знаний

   Получите статусы передачи маркировок:

• /v4/fbs/posting/product/exemplar/status — получить статус добавления экземпляров.
• /v5/fbs/posting/product/exemplar/create-or-get — получить данные созданных экземпляров.

4. До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:

   • заказ не в статусе awaiting_packaging;
   • вы не указали коды маркировки для товаров, подлежащих обязательной маркировке.

   При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.

   После использования метода статус отправления изменится на awaiting_deliver.

   Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.

Когда сборка заказа завершена, свяжитесь с покупателем для согласования даты доставки. Если покупателю не подходит дата, вы можете перенести её: /v1/posting/fbs/timeslot/set. Посмотрите доступные даты для переноса доставки и количество доступных переносов: /v1/posting/fbs/timeslot/change-restrictions.

Передайте отправление курьеру:

1. Когда курьер забрал отправление, измените статус отправления на «Доставляется»: /v2/fbs/posting/delivering.

   Одновременно с этим, если у отправления есть трек-номер, передайте его: /v2/fbs/posting/tracking-number/set.

2. Когда курьер едет к покупателю, поменяйте статус отправления на «Последняя миля»: /v2/fbs/posting/last-mile.

3. Когда курьер передал отправление покупателю, поменяйте статус на «Доставлено»: /v2/fbs/posting/delivered.

Отменить доставку отправления

1. Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.

2. Передайте этот список и номер отправления: /v2/posting/fbs/cancel.

Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.

Если отправление отменит покупатель, статус изменится на cancelled.

1. Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.

   Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать страну-производителя для всех товаров в заказе, у которых она не указана. Получите список доступных для выбора стран: /v2/posting/fbs/product/country/list. Затем передайте информацию о стране-производителе: /v2/posting/fbs/product/country/set.

   Также можно получать список заказов (отправлений): /v3/posting/fbs/list. Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики, если поле with отправить со значением analytics_data.

   Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.

2. Получите дополнительную информацию о заказах: /v3/posting/fbs/get.

   В блоке requirements указывается:

   • какие товары подлежат обязательной маркировке;
   • нужно ли передать номер грузовой таможенной декларации и регистрационный номер партии товара — эту информацию также можно получить с помощью методов /v3/posting/fbs/list и /v3/posting/fbs/unfulfilled/list.

   Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.

3. Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.

   С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.

   Подробнее о маркировке «Честный ЗНАК» в Базе знаний

   Получите статусы передачи маркировок:

• /v4/fbs/posting/product/exemplar/status — получить статус добавления экземпляров.
• /v5/fbs/posting/product/exemplar/create-or-get — получить данные созданных экземпляров.

4. До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:

   • заказ не в статусе awaiting_packaging;
   • вы не указали коды маркировки для товаров, подлежащих обязательной маркировке.

   При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.

   После использования метода статус отправления изменится на awaiting_deliver.

   Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.

5. Распечатайте этикетку для идентификации в системе Ozon: /v2/posting/fbs/package-label.

6. Передайте отправление курьеру.

Дальше подстатусы будут изменяться автоматически:

1. on_way_to_city — курьер забрал заказ.
2. on_way_to_pickup_point — курьер везёт заказ в пункт выдачи.
3. in_pickup_point — отправление приняли в пункте выдачи.
4. delivered — покупатель забрал заказ из пункта выдачи.

Чтобы проверить статус отправления, используйте метод /v3/posting/fbs/list.

Отменить доставку отправления

1. Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.

2. Передайте этот список и номер отправления: /v2/posting/fbs/cancel.

Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.

Если отправление отменит покупатель, статус изменится на cancelled.

1. Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.

   Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать страну-производителя для всех товаров в заказе, у которых она не указана. Получите список доступных для выбора стран: /v2/posting/fbs/product/country/list. Затем передайте информацию о стране-производителе: /v2/posting/fbs/product/country/set.

   Также можно получать список заказов (отправлений): /v3/posting/fbs/list. Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики, если поле with отправить со значением analytics_data.

   Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.

2. Получите дополнительную информацию о заказах: /v3/posting/fbs/get.

   В блоке requirements указывается:

   • какие товары подлежат обязательной маркировке;
   • нужно ли передать номер грузовой таможенной декларации и регистрационный номер партии товара — эту информацию также можно получить с помощью методов /v3/posting/fbs/list и /v3/posting/fbs/unfulfilled/list.

   Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.

3. Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.

   С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.

   Подробнее о маркировке «Честный ЗНАК» в Базе знаний

   Получите статусы передачи маркировок:

• /v4/fbs/posting/product/exemplar/status — получить статус добавления экземпляров.
• /v5/fbs/posting/product/exemplar/create-or-get — получить данные созданных экземпляров.

4. До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:

   • заказ не в статусе awaiting_packaging;
   • вы не указали коды маркировки для товаров, подлежащих обязательной маркировке.

   При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.

   После использования метода статус отправления изменится на awaiting_deliver.

   Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.

Передайте отправление в службу доставки. Все статусы от «Доставляется» до «Доставлено» будет передавать служба доставки.

Отменить доставку отправления

1. Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.

2. Передайте этот список и номер отправления: /v2/posting/fbs/cancel.

Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.

Если отправление отменит покупатель, статус изменится на cancelled.

1. Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.

   Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать страну-производителя для всех товаров в заказе, у которых она не указана. Получите список доступных для выбора стран: /v2/posting/fbs/product/country/list. Затем передайте информацию о стране-производителе: /v2/posting/fbs/product/country/set.

   Также можно получать список заказов (отправлений): /v3/posting/fbs/list. Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики, если поле with отправить со значением analytics_data.

   Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.

2. Получите дополнительную информацию о заказах: /v3/posting/fbs/get.

   В блоке requirements указывается:

   • какие товары подлежат обязательной маркировке;
   • нужно ли передать номер грузовой таможенной декларации и регистрационный номер партии товара — эту информацию также можно получить с помощью методов /v3/posting/fbs/list и /v3/posting/fbs/unfulfilled/list.

   Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.

3. Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.

   С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.

   Подробнее о маркировке «Честный ЗНАК» в Базе знаний

   Получите статусы передачи маркировок:

• /v4/fbs/posting/product/exemplar/status — получить статус добавления экземпляров.
• /v5/fbs/posting/product/exemplar/create-or-get — получить данные созданных экземпляров.

4. Если товар в отправлении упакован в несколько коробок, передайте их количество: /v3/posting/multiboxqty/set. Если не сделать этого до сборки, вам придётся объединить все коробки в одну.

5. До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:

   • заказ не в статусе awaiting_packaging;
   • вы не указали коды маркировки для товаров, подлежащих обязательной маркировке.

   При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.

   После использования метода статус отправления изменится на awaiting_registration.

   Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.

6. Когда перевозчик обработает отправление, его статус изменится с awaiting_registration на awaiting_delivery. После этого отправлению будет присвоен трек-номер.

   Для каждого отправления распечатайте этикетку для идентификации в системе Ozon: /v2/posting/fbs/package-label.

   Передайте отправление в службу доставки. Все статусы от «Доставляется» до «Доставлено» будет передавать служба доставки.

Если вы продаёте из Турции и вам нужны декларации Elektronik Ticaret Gümrük Beyannamesi (ETGB) для возврата налоговой пошлины, получите декларации: /v1/posting/global/etgb.

Отменить доставку отправления

1. Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.

2. Передайте этот список и номер отправления: /v2/posting/fbs/cancel.

Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.

Если отправление отменит покупатель, статус изменится на cancelled.

1. Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.

   Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать страну-производителя для всех товаров в заказе, у которых она не указана.
   Получите список доступных для выбора стран: /v2/posting/fbs/product/country/list. Затем передайте информацию о стране-производителе: /v2/posting/fbs/product/country/set.

   Также можно получать список заказов (отправлений): /v3/posting/fbs/list. Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики, если поле with отправить со значением analytics_data.

   Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.

   Если в параметре available_actions указано set_cutoff, уточните дату отгрузки отправления с помощью метода /v1/posting/cutoff/set. Сделайте это не позднее даты, которая указана в параметре shipment_date в методах: /v3/posting/fbs/unfulfilled/list, /v3/posting/fbs/list или /v3/posting/fbs/get. После даты shipment_date уточнить дату отгрузки и собрать отправление не получится.

2. Получите дополнительную информацию о заказах: /v3/posting/fbs/get.

   В блоке requirements указывается:

   • какие товары подлежат обязательной маркировке;
   • нужно ли передать номер грузовой таможенной декларации и регистрационный номер партии товара — эту информацию также можно получить с помощью методов /v3/posting/fbs/list и /v3/posting/fbs/unfulfilled/list.

   Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.

3. Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.

   С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.

   Подробнее о маркировке «Честный ЗНАК» в Базе знаний

   Получите статусы передачи маркировок:

• /v4/fbs/posting/product/exemplar/status — получить статус добавления экземпляров.
• /v5/fbs/posting/product/exemplar/create-or-get — получить данные созданных экземпляров.

4. До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:

   • заказ не в статусе awaiting_packaging;
   • вы не указали коды маркировки для товаров, подлежащих обязательной маркировке.

   При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.

   После использования метода статус отправления изменится на awaiting_deliver.

   Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.

5. Если в настройках метода доставки вы задали временной промежуток для передачи отправления в службу доставки, измените статус отправления на sent_by_seller — «Отправлено продавцом»: /v2/fbs/posting/sent-by-seller.

6. После передачи отправления в службу доставки измените статус отправления на delivering — «Доставляется»: /v2/fbs/posting/delivering.

7. Одновременно с этим, если у отправления есть трек-номер, передайте его: /v2/fbs/posting/tracking-number/set.

8. Когда курьер едет к покупателю, поменяйте статус отправления на «Последняя миля»: /v2/fbs/posting/last-mile.

9. Когда курьер передал отправление покупателю, поменяйте статус на «Доставлено»: /v2/fbs/posting/delivered.

1. Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.

   Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать страну-производителя для всех товаров в заказе, у которых она не указана.
   Получите список доступных для выбора стран: /v2/posting/fbs/product/country/list. Затем передайте информацию о стране-производителе: /v2/posting/fbs/product/country/set.

   Также можно получать список заказов (отправлений): /v3/posting/fbs/list. Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики, если поле with отправить со значением analytics_data.

   Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.

2. Получите дополнительную информацию о заказах: /v3/posting/fbs/get.

   В блоке requirements указывается:

   • какие товары подлежат обязательной маркировке;
   • нужно ли передать номер грузовой таможенной декларации и регистрационный номер партии товара — эту информацию также можно получить с помощью методов /v3/posting/fbs/list и /v3/posting/fbs/unfulfilled/list.

   Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.

3. Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.

   С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.

   Подробнее о маркировке «Честный ЗНАК» в Базе знаний

   Получите статусы передачи маркировок:

• /v4/fbs/posting/product/exemplar/status — получить статус добавления экземпляров.
• /v5/fbs/posting/product/exemplar/create-or-get — получить данные созданных экземпляров.

4. До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:

   • заказ не в статусе awaiting_packaging;
   • вы не указали коды маркировки для товаров, подлежащих обязательной маркировке.

   При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.

   После использования метода статус отправления изменится на awaiting_deliver.

   Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.

5. Для каждого отправления распечатайте этикетку для идентификации в системе Ozon: /v2/posting/fbs/package-label.

6. Если в настройках метода доставки вы задали временной промежуток для передачи отправления в службу доставки, измените статус отправления на sent_by_seller — «Отправлено продавцом»: /v2/fbs/posting/sent-by-seller.

Передайте отправление в службу доставки. Все статусы от «Доставляется» до «Доставлено» будет передавать служба доставки.

Отменить доставку отправления

1. Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.

2. Передайте этот список и номер отправления: /v2/posting/fbs/cancel.

Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.

Если отправление отменит покупатель, статус изменится на cancelled.

Перед тем, как перевести заказ с весовыми товарами в статус «Ожидает отгрузки» — awaiting_delivery, передайте уточнённые данные о весе товаров. Для этого после взвешивания перед сборкой передайте информацию о весе каждого экземпляра весовых товаров через метод /v6/fbs/posting/product/exemplar/set.

Метод /v6/fbs/posting/product/exemplar/set вернёт ошибки:

• WEIGHT_IS_OUT_OF_RANGE — если вы передали вес, который выходит за границы допустимого;
• WEIGHT_IS_REQUIRED — если вы не передали вес для весовых товаров.

Если в методе /v3/posting/fbs/get в параметре result.products.is_weight_needed для товара указано значение true, взвесьте товар.

После передачи корректного веса для всех экземпляров всех весовых товаров вы сможете перевести отправление в статус «Ожидает отгрузки» — awaiting_delivery.

Если в заказе с весовыми товарами есть невзвешенные товары, при вызове метода /v4/posting/fbs/ship вернётся ошибка WEIGHT_IS_REQUIRED.

Прямая поставка

1. /v1/fbp/warehouse/list — получите список партнёрских складов.

2. /v1/fbp/draft/direct/product/validate — передайте список товаров, чтобы проверить, может ли склад партнёра их принять.

3. /v1/fbp/draft/direct/timeslot/get — получите список таймслотов для прямой поставки.

4. Выберите способ доставки:

   Доставка силами продавца

   • /v1/fbp/draft/direct/seller-dlv/create — создайте черновик заявки на поставку.
   
   • /v1/fbp/draft/direct/timeslot/edit — измените таймслот для поставки в черновике заявки.
   
   • /v1/fbp/draft/direct/seller-dlv/edit — обновите информацию о доставке силами продавца в черновике заявки.

   Доставка силами сторонней транспортной компании

   • /v1/fbp/draft/direct/tpl-dlv/create — создайте черновик заявки на поставку.
   
   • /v1/fbp/draft/direct/timeslot/edit — измените таймслот для поставки в черновике заявки.
   
   • /v1/fbp/draft/direct/tpl-dlv/edit — обновите информацию о доставке силами сторонней траспортной компании в черновике заявки.

5. /v1/fbp/draft/list — получите список черновиков.

6. /v1/fbp/draft/get — получите информацию о черновике на поставку. Если в черновике есть ошибка, используйте /v1/fbp/draft/direct/delete, чтобы удалить его.

7. /v1/fbp/draft/direct/registrate — переведите черновик заявки на поставку в активную заявку.

8. /v1/fbp/order/direct/timeslot/list — получите актуальные таймслоты склада для поставки.

9. /v1/fbp/order/direct/timeslot/edit — измените актуальный таймслот поставки.

10. /v1/fbp/order/direct/seller-dlv/edit или /v1/fbp/order/direct/tpl-dlv/edit — передайте актуальную информацию о доставке, если доставляете самостоятельно или через перевозчика.

11. /v1/fbp/order/list — получите список поставок.

12. /v1/fbp/order/get — получите информацию о конкретной поставке. Если в заявке на поставку есть ошибка, используйте /v1/fbp/order/direct/cancel, чтобы отменить поставку.

13. /v1/fbp/label/create — создайте задание на генерацию этикеток.

14. /v1/fbp/label/get — получите этикетки и статус задания на их генерацию.

15. /v1/fbp/act-to/create — создайте задание на генерацию транспортной накладной.

16. /v1/fbp/act-to/get — получите транспортную накладную и статус задания на её генерацию.

17. /v1/fbp/act-from/create — создайте задание на генерацию акта приёмки.

18. /v1/fbp/act-from/get — получите акт приёмки и статус задания на его генерацию.

19. /v1/fbp/archive/list — получите список завершённых поставок.

20. /v1/fbp/archive/get — получите информацию о конкретной завершённой поставке.

Поставка на партнёрский пункт приёма заказов

1. /v1/fbp/warehouse/list — получите список партнёрских складов.
2. /v1/fbp/draft/drop-off/product/validate — проверьте, может ли склад партнёра принять товары.
3. /v1/fbp/draft/drop-off/province/list — получите список провинций.
4. /v1/fbp/draft/drop-off/point/list — получите список пунктов в провинции.
5. /v1/fbp/draft/drop-off/point/timetable — получите расписание пункта.
6. /v1/fbp/draft/drop-off/create — создайте черновик для drop-off доставки.
7. /v1/fbp/draft/drop-off/dlv/edit — измените детали drop-off доставки для черновика.
8. /v1/fbp/draft/list — получите список черновиков.
9. /v1/fbp/draft/get — получите информацию о конкретном черновике поставки. Если в черновике есть ошибка, используйте /v1/fbp/draft/drop-off/delete, чтобы удалить его.
10. /v1/fbp/draft/drop-off/registrate — переведите черновик заявки на поставку в активную заявку.
11. /v1/fbp/order/drop-off/timetable — получите график работы drop-off пункта.
12. /v1/fbp/order/drop-off/dlv/edit — отредактируйте и передайте информацию о доставке на drop-off пункт.
13. /v1/fbp/order/list — получите список поставок.
14. /v1/fbp/order/get — получите информацию о конкретной поставке. Если в заявке на поставку есть ошибка, используйте /v1/fbp/order/drop-off/cancel, чтобы отменить поставку.
15. /v1/fbp/label/create — создайте задание на генерацию этикеток.
16. /v1/fbp/label/get — получите этикетки и статус задания на их генерацию.
17. /v1/fbp/act-to/create — создайте задание на генерацию транспортной накладной.
18. /v1/fbp/act-to/get — получите транспортную накладную и статус задания на её генерацию.
19. /v1/fbp/act-from/create — создайте задание на генерацию акта приёмки.
20. /v1/fbp/act-from/get — получите акт приёмки и статус задания на его генерацию.
21. /v1/fbp/archive/list — получите список завершённых поставок.
22. /v1/fbp/archive/get — получите информацию о конкретной завершённой поставке.

Вывоз товаров со склада продавца

1. /v1/fbp/warehouse/list — получите список партнёрских складов.
2. /v1/fbp/draft/pick-up/product/validate — проверьте, может ли склад партнёра принять товары.
3. /v1/fbp/draft/pick-up/create — создайте черновик для pick-up доставки.
4. /v1/fbp/draft/pick-up/dlv/edit — измените детали pick-up доставки для черновика.
5. /v1/fbp/draft/list — получите список черновиков.
6. /v1/fbp/draft/get — получите информацию о конкретном черновике поставки. Если в черновике есть ошибка, используйте /v1/fbp/draft/pick-up/delete, чтобы удалить его.
7. /v1/fbp/draft/pick-up/registrate — переведите черновик заявки на поставку в активную заявку.
8. /v1/fbp/order/pick-up/dlv/edit — измените информацию о pick-up пункте.
9. /v1/fbp/order/list — получите список поставок.
10. /v1/fbp/order/get — получите информацию о конкретной поставке. Если в заявке на поставку есть ошибка, используйте /v1/fbp/order/pick-up/cancel, чтобы отменить поставку.
11. /v1/fbp/label/create — создайте задание на генерацию этикеток.
12. /v1/fbp/label/get — получите этикетки и статус задания на их генерацию.
13. /v1/fbp/act-to/create — создайте задание на генерацию транспортной накладной.
14. /v1/fbp/act-to/get — получите транспортную накладную и статус задания на её генерацию.
15. /v1/fbp/act-from/create — создайте задание на генерацию акта приёмки.
16. /v1/fbp/act-from/get — получите акт приёмки и статус задания на его генерацию.
17. /v1/fbp/archive/list — получите список завершённых поставок.
18. /v1/fbp/archive/get — получите информацию о конкретной завершённой поставке.

• /v2/posting/fbs/act/list — получите список сформированных ранее актов.
• /v2/posting/fbs/act/get-postings — получите список отправлений по каждому акту.

/v1/returns/list — получите информацию о возвращённых товарах.

Убедитесь, что вы можете получать возвратные отгрузки по штрихкоду: /v1/return/giveout/is-enabled. Если у вас есть доступ, в параметре enabled будет указано значение true.

Чтобы получить возвратную отгрузку, запросите штрихкод:

• /v1/return/giveout/get-pdf — получить штрихкод в формате PDF.
• /v1/return/giveout/get-png — получить штрихкод в формате PNG.
• /v1/return/giveout/barcode — получить штрихкод в текстовом виде.

Получите информацию и список возвратных отгрузок:

• /v1/return/giveout/list — получить список возвратных отгрузок.
• /v1/return/giveout/info — получить информацию о выбранной отгрузке.

Вы можете забрать возвраты отдельно от поставки товаров. Если для проезда на склад Ozon нужен пропуск, создайте его с помощью метода /v1/return/pass/create. Для каждого проезда за возвратами нужен новый пропуск.

Для редактирования и удаления пропуска используйте методы /v1/return/pass/update и /v1/return/pass/delete.

Список всех пропусков можно получить с помощью метода /v1/pass/list.

Подробнее об оформлении пропусков

Получите заявки и информацию о них:

• /v2/returns/rfbs/get — получите информацию по заявке на возврат rFBS.
• /v2/returns/rfbs/list — получите список заявок на возврат rFBS.

Вы можете одобрить, компенсировать, подтвердить возврат денег, запросить товар для проверки и отклонить заявку методом /v1/returns/rfbs/action/set. Для передачи корректного action получите список доступных для конкретного возврата, в методе /v2/returns/rfbs/get.

Получите заявки и информацию о них: /v2/conditional-cancellation/list.

Примите решение по новой заявке на отмену — подтвердите или отклоните её:

• /v2/conditional-cancellation/approve — подтвердите заявку на отмену rFBS. Заказ будет автоматически отменён, а деньги вернутся покупателю.
• /v2/conditional-cancellation/reject — отклоните заявку на отмену rFBS. Заказ останется в том же статусе, и его нужно будет доставить покупателю.

Для получения списка чатов используйте /v3/chat/list. В ответе будут идентификаторы текущих чатов и последних сообщений.

Для отправки сообщений по идентификатору чата используйте методы:

• /v1/chat/send/message — для отправки текстового сообщения.

• /v1/chat/send/file — для отправки файла или изображения.

Для получения истории чата по идентификатору чата или сообщения используйте метод /v3/chat/history. Направление сортировки по умолчанию — от новых сообщений к старым.

Если указать идентификатор сообщения, то история начнётся с этого сообщения.

Чтобы создать новый чат с покупателем по номеру отправления, воспользуйтесь /v1/chat/start.

Чтобы отметить сообщение и все сообщения до него прочитанными, используйте /v2/chat/read.

При запросе любого из отчётов сначала возвращается код на создание документа. Отправьте его в запросе метода /v1/report/info — в ответе вернётся файл отчёта и дополнительная информация.

Чтобы получить список сформированных ранее отчётов, используйте /v1/report/list.

Методы для получения отчётов:

• /v1/report/products/create — отчёт с данными о товарах, например Ozon ID, описанием товара, цены, комиссии или габаритов упаковки.

• /v3/finance/transaction/list — отчёт по транзакциям, доступный в личном кабинете продавца.

• /v4/product/info/price — отчёт по ценам.

• /v1/report/warehouse/stock — отчёт по остаткам на складе.

• /v2/report/returns/create — отчёт о возвращённых товарах для FBS и rFBS. Отчёт содержит товары, принятые от покупателя, готовые к получению или переданные продавцу.

• /v1/report/postings/create — отчёт об отправлениях.

• /v1/finance/cash-flow-statement/list — финансовый отчёт.

• /v1/report/discounted/create — отчёт об уценённых товарах.

• /v1/analytics/data — получите данные аналитики.

  Если укажете период и метрики, которые нужно рассчитать, в ответе будет аналитиĸа, сгруппированная по параметру dimensions.

• /v1/analytics/stocks — получите аналитику по остаткам товаров на складах.

Чтобы получить отчёт по оборачиваемости FBO, запросите его в личном кабинете.

• /v3/finance/transaction/list — получите подробную информацию по транзакциям для отправления.

• /v3/finance/transaction/totals — получите детальную информацию по итоговым суммам транзакций за указанный период.

• /v1/rating/summary — получите текущие значения рейтингов продавца.

• /v1/rating/history — получите информацию о рейтингах продавца за период и количество штрафных баллов, начисленных в Premium-программе.